home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / dskut / pup330.zip / PUP.DOC < prev    next >
Text File  |  1992-05-03  |  10KB  |  260 lines
  1.  
  2.  
  3.             PUP: Paul's Utility Program Version 3.30
  4.  
  5.  
  6. Sorry for version 3.18, there were some major bugs that I didn't test for.
  7.  
  8. The file manager you always wanted to have but were afraid to write it.
  9. It is completely mouse operated, so it will save you a lot of type-errors,
  10. lame fingers etc.
  11.  
  12. It can do all your file managing, including processing archived files ( ZIP,
  13. ZOO, ARC, LZH, ICE, ARJ -files ) so it will save you a huge amount of work
  14. finding the correct commands, options, modifiers and whatever for the correct
  15. actions of the archiving programs.
  16.  
  17. FILES:
  18. ======
  19.  
  20.   PUP.CFG       Config file for PUP. You may edit this a bit. See downwards
  21.   PUP.COM       The PUP program itself
  22.   PUP.DOC       This file
  23.   PUPCFG.EXE    The config program for PUP
  24.   INSTALL.BAT   The same, but this way you are more likely to run it the
  25.                 first time
  26.   MAIN.PUP      The main file needed for PUP
  27.   V.COM         The multiple file viewer
  28.   VIEW.CFG      The config file for V.COM
  29.   VIEW.DOC      The file explaining the use of V.COM
  30.  
  31. INSTALLATION
  32. ============
  33.  
  34. PUP requires a mouse driver preferably set in the 3-button mode, so if you
  35. don't have one you better buy it before you install this program.
  36.  
  37. The installation is very simple. Just follow the questions of the installation
  38. program.
  39.  
  40. OPERATION
  41. =========
  42.  
  43. This is also very simple.
  44. The meaning of the mouse buttons is as follows:
  45.  
  46.  Left  button: Execute or unzip, unarc, unpak, etc. a program or a file.
  47.                ( When executing a program PUP asks you if you want to give
  48.                  some arguments to the program. You can also click on
  49.                  'quit' if you accidentally clicked on the wrong program. )
  50.  Mid   button: Mark a file or directory for later use (copy, move, rename ...).
  51.  Right button: View/edit an ordinary file with your favorite editor,
  52.                or show the contents of a archived file.
  53.  
  54.  Note: When you have a 2-button mouse don't worry, because you can still mark
  55.        a file with SHIFT- left (or right) button.
  56.  
  57.  Directory's are changed by pressing the left or right button on your mouse.
  58.  
  59. The menu commands can be selected by any one of the buttons and are as follows:
  60.  
  61.   quit : Returns you to ordinary DOS (You must type all of it yourself so
  62.          don't use this).
  63.   ?:   : This is for changing the current drive.
  64.   read : Is for re-reading a disk and rewriting the screen (very useful if
  65.          something corrupted the screen).
  66.   mdir : Make a new directory in the current directory.
  67.   disp : Display mode.
  68.          disk:     - You can display some information on the free space of the
  69.                      current disk, the number of marked files, the size of the
  70.                      marked files etc.
  71.          2col/4col:- Switch to 2 or to 4 column display.
  72.          nhid/hidd:- Choose if you want to display hidden files or not
  73.          time/attr:- If you are in 2-column mode you can choose between
  74.                      time or attributes displayed
  75.   sort : Lets you choose a sorting order for the files on the screen
  76.          (this order is preserved after executing a program).
  77.   copy : For copying the marked files to another drive or directory. After
  78.          clicking on 'copy' you can choose a directory to where the
  79.          files must be copied.
  80.   move : Same as copy, but the original files will be deleted.
  81.   del  : Delete the marked files.
  82.   rena : Rename the marked files. You can use wildcards ( "*" and "?" ).
  83.   attr : Change the attributes of the marked files.
  84.   arch : Puts the marked files into an archive with the desired archiving
  85.          program.
  86.   exec : Execute a program that is in a directory specified in your PATH
  87.          variabele or a regular DOS-command.
  88.   mark : "*.* " : Mark all files.
  89.          "user" : Mark a number of files by the use of wildcards ? and *
  90.                   (They have the same meaning as in DOS).
  91.          "none":  Delete all the markers.
  92.  
  93.          When marking files bear in mind that files already marked will be
  94.          unmarked (useful when for instance deleting everything except .PAS
  95.          files, you mark all (with *.*) and then mark (actually unmark) the
  96.          PAS files with option "user" (type *.PAS).
  97.  
  98.   After clicking on 'copy', 'move' or UNZIP etc you can choose a directory the
  99.   same way you choose them when you are moving to the directory's and drives
  100.   when you want to execute a program.
  101.   In addition when choosing such paths you can make a new directory,
  102.   change display mode and and set sorting order.
  103.  
  104.   Note 1: To choose an option from a menu choice, hold down the button while
  105.           moving your mouse downwards.
  106.  
  107.   Note 2: When you copy or move files or directory's to the current directory,
  108.           you will be asked for a new filename, because you can't copy a file
  109.           to itself.
  110.           ( Move a file to the current directory is the same as rename )
  111.           Caution: If you move files to the current directory and the same
  112.                    name (who will ever do this?) you lose your file.
  113.  
  114.   Note 3: There is a known bug in PUP.When you move or delete a file on a
  115.           write-protected disk you get some pretty stupid things. I guess the
  116.           file-system gets confused, but I'm not sure what to do about that.
  117.           Whoever can help me with this, gets the registration for free!!!!
  118.           ( I think it is a DOS bug )
  119.  
  120. About PUP.CFG:
  121.  
  122. In versions after 3.20 the PUP.CFG file is as follows:
  123. 1st: the command and arguments for extracting files
  124. 2nd: the command and arguments for archiving files when the program accepts
  125.      a filelist
  126.      followed by an empty line
  127. or   the command and arguments for archiving files.
  128.      the command and arguments for archiving directory's.
  129.  
  130. this 3 lines repeated for every archiving program there is.
  131. You may edit the PUP.CFG file yourself, but be sure not to add or delete any
  132. lines or change the order.
  133.  
  134. Updates
  135. =======
  136.  
  137. Improvements with regard to version 2.01:
  138.  
  139. - The pull-down menus stay open until the whole action has finished,
  140.   so if you get an error message you can see what caused it.
  141.  
  142. - There was a bug in the copy part, it left part of the copy in the specified
  143.   directory if there occurred an error.
  144.  
  145. Improvements with regard to version 2.03:
  146.  
  147. - There was a major bug in the pupcfg program. It's ok now.
  148.  
  149. Improvements with regard to version 2.10:
  150.  
  151. - It was not ok then. Fixed it for sure.
  152.   Also a minor error fixed. (When you unzipped etc a file to a disk that became
  153.   full, the warning from the archiving program went so fast of screen that you
  154.   couldn't see it. It pauses now.
  155.  
  156. Improvements with regard to version 2.20:
  157.  
  158.  - Not very much, some minor changes.
  159.  
  160. Improvements with regard to version 2.21:
  161.  
  162.  - Fixed some of the error handling.
  163.  - You can change the color of the commands on the second line now.
  164.  - Standard archiving programs: PKZIP, PKPAK, ARJ, LHA and PAK.
  165.  - You can choose if you want to preserve the directory on start-up.
  166.  - After viewing a file PUP displays the same part of the directory as it
  167.    did before ( this is only if the directory doesn't fit on one screen ).
  168.  
  169. Improvements with regard to version 2.30:
  170.  
  171.  - Added wildcards in the renaming.
  172.  - Fixed some silly bug.
  173.  - The total size of the marked files is now always displayed.
  174.  
  175. Improvements with regard to version 2.30:
  176.  
  177.  - did some bugfixing
  178.  - translated source from pascal to assembly!!! (Terrible job)
  179.    so PUP is about 70% (!) shorter and a bit faster.
  180.  - you can also execute BTM files (Batch To Memory)
  181.  - PUP.COM is now 384 Bytes in memory !!!
  182.  
  183. Improvements with regard to version 3.00 and 3.01:
  184.  
  185.  - Fixed some bugs, some for the second time (??). Hope I got them all.
  186.  - P.S. I'm sorry about the not working version of pup ( some silly guy up-
  187.    loaded a non-working pre-release of pup (pup 3.00) so if you got frustrated
  188.    about the not working of pup I'll give you his address for a suitable fee ).
  189.  - Added the SHIFT-button operation.
  190.  
  191. Improvements with regard to version 3.10:
  192.  
  193.  - Fixed some